SET DISPLAY MODE

This command will set the screen display mode if it is available on the current graphics card.

  Syntax 
SET DISPLAY MODE Width, Height, Depth

SET DISPLAY MODE Width, Height, Depth, VSyncOn

SET DISPLAY MODE Width, Height, Depth, VSyncOn, Multisampling Factor, Multimonitor Mode
  Parameters 
Width
Integer
The width of the screen resolution to set 
Height
Integer
The height of the screen resolution to set 
Depth
Integer
The depth of the screen resolution of set 
VSyncOn
Integer
Set VSyncOn to a value of one will force the screen to use VSYNC and syncronise to the monitors refresh rate 
Multisampling Factor
Integer
Set Multisampling Factor to map direct to the D3DMULTISAMPLE_TYPE format in DirectX, ideal for setting multisampling screens for anitaliasing 
Multimonitor Mode
Integer
Set Multimonitor Mode to one in order to double the widge of the resolution, allowing a fullscreen application to expand to a second monitor or for some stereoscopic uses

  Returns

This command does not return a value.

  Description

If this command fails, it will only generate a runtime warning in the CLI. A final EXE produced with this command will not cause your program to fail on machines that do not support the resolution. It is recommended, however, that you check the availability of the display mode before using this command. You can use the CHECK DISPLAY MODE() command to see whether the display mode is supported. It is vital to know that when this command is called, everything is deleted, including music and sound, so you must re-load all your assets after a call to this command. An additional property to force VSYNC on or off (cap to 60fps or not). Using SYNC RATE is something of a hack when compared to this new feature which creates a perfect VSYNC between the render and the monitor. The downside is that the VSYNC is fixed to the refresh of the monitor. Be aware that if the rendering area is stretched (usually via window desktop and window fullscreen modes), then it will not be a true framerate returned by "screen fps()". 8-Bit screen resolutions are not supported.

  Example Code 
cls

set display mode 800,600,32

set window on

maximize window

wait 1000*8

print "screen width "+str$(screen width()) 

print "screen height "+str$(screen height()) 

print "screen depth "+str$(screen depth()) 

do

loop

end
  See also

DISPLAY Commands Menu
 Index